home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / timer100.arc / TIMER.DOC < prev    next >
Text File  |  1990-04-21  |  4KB  |  88 lines
  1.  
  2.                                  TIMER
  3.  
  4.                              by David Arens
  5.  
  6.  
  7.  
  8.      TIMER is a Telix script which will call (or run) other scripts at a
  9. specified time.  There are currently several other scripts which will do
  10. this also, but none that I have found will display the results like
  11. TIMER will.
  12.  
  13.      In a Telix script, an integer variable can be returned (to the
  14. calling script) for any number of conditions.  TIMER has the ability to
  15. interpret the value in this variable and display a text string
  16. corresponding to that value.  For example, I have scripts for every BBS
  17. I call that will log-in, check new files list, download new mail (if
  18. any), and log-off, all unattended.  I have set up TIMER for myself in
  19. the following manner:
  20.  
  21.               Called script returns      TIMER displays
  22.  
  23.                         1                 No Connection Made
  24.                         2                 No New Mail
  25.                         3                 New Mail Downloaded
  26.  
  27.      TIMER can interpret values from a range of -999999999 to 2147483647
  28. and will display a string of text for that value up to 20 characters
  29. long.  You may specify up to 10 different values for TIMER to interpret.
  30. See the Telix SALT manual for more information on returns and integer
  31. variables.
  32.  
  33.      On first running TIMER, you will be asked if you want to select
  34. colors for TIMER to use in its displays.  If you don't wish to select
  35. colors, TIMER will use Telix's foreground and background colors as a
  36. default.  You will then be asked if you want TIMER to interpret returns
  37. from called scripts.  If you don't, the config file (TIMER.CNF) will be
  38. written and placed in the same directory as your Telix files, and TIMER
  39. will go to its first display screen.  If you do wish for TIMER to
  40. interpret returns, you will be asked to enter a value.  You may only
  41. enter a number from -999999999 to 2147483647.  Then TIMER will ask for
  42. the text string to display for this value, and you may enter up to 20
  43. characters.  TIMER will continue asking for values and text strings
  44. until a total of 10 have been entered, or you may press ESCAPE at any
  45. time when you have finished.  Then TIMER will write the config file and
  46. present you with the first display.
  47.  
  48.      TIMER's first display screen:  Following the prompts TIMER gives
  49. you will be asked for a filename of a script, and hour and minutes that
  50. it should be run. (Enter 24-hour format for hour, i.e. 18 for 6 PM)
  51. You may hit ESCAPE at any of these prompts to exit TIMER.  After a valid
  52. filename and time is entered, you have the option of running this script
  53. at the same time every day.  If you enter Y, TIMER will write a que file
  54. (TIMER.QUE) containing this information and every time that TIMER is
  55. run, this script will be installed automatically.  You may enter up to 5
  56. daily scripts.  When TIMER has enough information it will go to the main
  57. display screen, showing the scripts to be executed, as well as the
  58. status box.
  59.  
  60.      After a script has run and control returns to TIMER, that script
  61. name will be displayed in the status box.  If you chose to have TIMER
  62. interpret returns, a larger status box will be displayed with the text
  63. string you entered next to the script name.  Keep in mind that if a
  64. value was returned from your script that has not been defined for TIMER
  65. to interpret, that this space will be empty.
  66.  
  67.      While TIMER is waiting to execute scripts, you may press A to add
  68. another script, R to remove a script, or Q to quit TIMER. (At this time,
  69. TIMER will only accept up to 5 scripts to run)  When TIMER has executed
  70. all scripts, (unless any are daily) it will exit and control returns to
  71. Telix.  If any scripts are defined as daily, TIMER will remain in
  72. executing mode and run them again at the same time the next day.
  73.  
  74.          -------------------------------------------------------------
  75.  
  76.      TIMER is being offered as FreeWare -- if you like it please feel
  77. free to use it, with no obligation or registration required.  All I ask
  78. is that you fill out the form included and mail it to me.  Also, if you
  79. do happen to have a few dollars burning a hole in your pocket, let me
  80. assure you that all contributions will be graciously accepted.
  81.  
  82.      If you have problems or questions concerning TIMER, you can leave a
  83. message for me on the Telix BBS.  Enjoy !!
  84.  
  85.  
  86.           Telix and SALT trademarks are Copyright (C) by Exis, Inc.
  87.  
  88.